Piattaforma di Gestione Rete Italia

Panoramica del Sistema

CRO (Central Routing Optimizer) è una piattaforma enterprise sviluppata per l'analisi di fattibilità, il rilascio e la gestione dei collegamenti DWDM (Dense Wavelength Division Multiplexing) e fibra ottica su due reti Telecom Italia: RC Italia (Rete Core) e RA Italia (Rete di Aggregazione).

Il sistema integra un motore di calcolo percorsi avanzato basato su algoritmo Dijkstra modificato, database separati per RC e RA con migliaia di collegamenti, e visualizzazioni geografiche interattive su mappe topografiche OpenStreetMap.

Ambito di Applicazione

CRO è progettato per supportare:

• Richieste di Fattibilità Tecnica: verifica rapida della realizzabilità di nuovi collegamenti su entrambe le reti
• Riconfigurazioni di Rete: analisi impatto e percorsi alternativi per modifiche topologiche
• Verifiche di Percorso: controllo tracciati esistenti e conformità progettuale
• Analisi Manutentive: studio collegamenti NON ATTIVI e possibili ripristini
• Scenari Alternativi: simulazioni what-if per disaster recovery e resilienza
• Ottimizzazione Routing: identificazione percorsi più efficienti per riduzione latenza/costi
• Capacity Planning: supporto decisionale per investimenti infrastrutturali

🔄 Processo di Fattibilità — Workflow Operativo

Il processo di fattibilità per servizi di connettività TIM si articola in due macro-scenari principali, che coinvolgono diverse componenti dell'infrastruttura di rete. L'analisi richiede l'utilizzo coordinato dei tool NAT (National Topography) e CRO (Central Routing Optimizer).

Componenti Architetturali Principali

Stack Tecnologico

Metriche di Performance

1) Caricamento e verifica DB

• Verifica che i DB siano presenti (RC: RAW_DB, RA: RAW_DB_RA). In assenza DB, il tool resta stabile (NODB safe) ma non calcola percorsi.
• Se noti risultati “vuoti” o bottoni inattivi, controlla che il DB sia stato realmente iniettato nella pagina.

2) Ricerca rapida RA / RC

• Seleziona 🚀 Centrale di Partenza e 🏁 Centrale di Arrivo.
• (Opzionale) imposta Arco vincolo e/o parametri di diversificazione.
• Avvia il calcolo (Std / Div). Se necessario, usa 🧹 Pulisci Tabella o ↩️ Undo.

3) Ricerca UNIFICATO (RA + RC)

• Imposta Partenza e Arrivo e (se previsto) il toggle POP.
• Avvia ⚡ Calcola Percorso UNIFICATO RA + RC per gestire casistiche miste (RA↔RC).
• Per iterazioni rapide usa ↩️ Undo (Ultime 20) o 🧼 Reset Tab (azzera l’intera tab UNIFICATO).

4) Modalità Cliente Sede A → Rete → Sede Z

• Inserisci le coordinate di Sede A e Sede Z (Lat/Lon) oppure usa 🔎 Trova Centrale Vicina dove disponibile.
• Avvia 🚀 Calcola Percorso Cliente Sede A → Rete → Sede Z per ottenere il percorso end-to-end.

5) Copia/Esportazione e Mappa

• Usa 📋 Copia Percorso, 🔗 Copia ID Collegamenti e 🗺️ Maps per condivisione rapida.
• Apri la 🗺️ Mappa Topografica per verificare visivamente il tracciato e (se disponibile) attivare/disattivare collegamenti.

Architettura Three-Tier

CRO adotta un'architettura three-tier (presentazione, logica, dati) completamente client-side per massimizzare performance e ridurre latenza. Non richiede server backend per operazioni ordinarie.

Flusso Dati Operativo

Workflow tipico di una ricerca percorsi:

1. Input Utente → Form "Ricerca Percorsi" con selezione A/Z e vincoli
2. Validazione Input → Controllo esistenza centrali, coerenza vincoli, range valori
3. Preprocessing → Costruzione grafo di rete da database, applicazione filtri stato
4. Algoritmo Dijkstra → Calcolo K-shortest paths (K=30) con vincoli attivi
5. Path Diversification → Calcolo 10 percorsi Div con overlap <30% rispetto a 1.1
6. Postprocessing → Eliminazione duplicati, ordinamento distanza, aggregazione metadati
7. Rendering Risultati → Popolamento tabelle HTML, disegno percorsi su mappa
8. User Interaction → Selezione percorsi, zoom mappa, export TXT/CSV

Gestione Stato Applicazione

Lo stato applicativo è gestito tramite pattern Observable con listeners su eventi DOM. Variabili globali di stato includono:

Sicurezza e Validazione

Meccanismi di sicurezza implementati:

• Input Sanitization - Escape caratteri speciali, validazione range numerici
• SQL Injection Prevention - N/A (no backend SQL, solo JSON client-side)
• XSS Protection - textContent invece di innerHTML per user input
• CSRF Protection - N/A (applicazione stateless senza autenticazione)
• Rate Limiting - Throttling ricerche (max 1/secondo) per prevenire abuse
• Data Validation - Schema validation per tutti i record database

Scalabilità e Performance

1. Algoritmo Dijkstra Vincolato

Motore di calcolo basato su algoritmo Dijkstra con estensioni proprietarie per la gestione di vincoli avanzati di rete. Supporta il calcolo parallelo fino a 300 percorsi primari (Std) (default 30), ottimizzati per distanza minima, e fino a 10 percorsi alternativi diversificati (Div) con overlap massimo configurabile.

• Centrali obbligatorie (selezione multipla)
• Centrali da evitare (blacklist)
• Vincoli di distanza minima e massima (km)
• Numero minimo e massimo di collegamenti (hop count)
• Filtro "Solo Collegamenti NON ATTIVI" per analisi su tratte dismesse o pianificate
• Eliminazione intelligente dei percorsi duplicati
• Validazione topologica in tempo reale dei risultati

2. Database Enterprise RC Italia

Repository con 500+ centrali e metadati completi. Funzionalità:

• Ricerca case-insensitive su ID, GAT, CLLI, Nome
• Filtri per Zona (NORD/CENTRO/SUD), Area, Regione
• Personalizzazione colonne visualizzate
• Export CSV con encoding UTF-8 BOM
• Selezione multipla per operazioni batch

3. Geocodifica & Centrale più Vicina

Conversione automatica indirizzo → coordinate WGS84 tramite Nominatim API OpenStreetMap. Algoritmo Haversine per calcolo distanze ortodromiche. Identificazione automatica della centrale più vicina con indicatore permanente sulla mappa.

4. Mappa Topografica Interattiva

Visualizzazione con Leaflet.js e auto-inizializzazione. Features:

• Overlay percorsi con codifica colori (primari blu, alternativi arancione)
• Layer control per gestione visibilità
• Misurazione distanze tra due punti (attivabile)
• Zoom automatico su selezione o intera rete
• Highlight mode per evidenziare percorsi specifici

5. Calcolo Attenuazione ITU-T

Stima professionale perdite in fibra ottica secondo standard ITU-T. Layout ottimizzato a 2 colonne:

• Colonna Sinistra: Form input (tipo fibra, lunghezza, collegamenti) + risultato stile "Riepilogo Economico" con tabella dettagliata
• Colonna Destra: Legenda con formula ITU-T, tabella coefficienti α (dB/km), note connettorizzazioni, esempio pratico
• Multimodale (MM): 850 nm (α=3.0 dB/km), 1300 nm (α=1.0 dB/km)
• Monomodale (SM): 1310 nm (α=0.35 dB/km), 1550 nm (α=0.22 dB/km)
• Calcolo perdite connettorizzazioni (0.3 dB cadauna, 2 per bretella)
• Output formattato: tipo fibra, km, collegamenti, perdita fibra, perdita connettori, totale dB

6. Sistema Undo Intelligente

Cronologia automatica delle ultime 20 ricerche con salvataggio completo parametri. Ripristino istantaneo con un click. Persistenza in localStorage tra sessioni browser. Risparmio stimato: da 5 minuti a 5 secondi!

7. Export Multi-formato

Export percorsi in formato TXT (percorsi Std e Div separati) e CSV per elaborazioni Excel. Bottone "Copia Formattata" per clipboard. Output CR/GI ready.

8. Analisi Costi per Fattibilità

Modulo dedicato alla stima dei costi associati a Link, Code Cliente e Apparati/Cestelli. Features:

• Riepilogo economico calcolato in tempo reale
• Selezione multipla su tre pannelli: Link RA/RC, Coda Cliente, Apparati
• Visualizzazione costi con e senza sconto
• Export riepilogo in formato TXT

9. Dashboard S.d.F. Internalizzati

Sistema completo di monitoraggio e analisi delle Schede di Fattibilità Internalizzate (Retail & Wholesale) con dashboard interattiva:

• Caricamento Excel Multi-Foglio: import file "SDF internalizzati" con supporto per più fogli (es: 2025 e 2026), elaborazione locale nel browser
• Filtro Anno: selezione "Tutto" (default), "Solo 2025" o "Solo 2026" per visualizzare le pratiche del periodo desiderato
• 8 KPI Real-time: S.d.F. Assegnati, Completati, Da Lavorare, Annullati, Retail, Wholesale, Interventi Dimensionali, Interventi Infrastrutturali
• 6 Grafici Interattivi: distribuzione per Stato, Tipo, Priorità, Territorio, Esito, Scadenze
• Filtri Avanzati: ricerca testuale su Fattibilità/Cliente/Note, filtri dropdown per Tipo/Esito/Priorità/Territorio/Lavorante
• Filtro Anno: selezione "Tutto", "Solo 2025" o "Solo 2026" per visualizzare pratiche del periodo desiderato
• Tabella Dettagliata: 16 colonne con ordinamento dinamico e highlight scadenze
• Colonne disponibili: Fattibilità, Descrizione/Cliente, Tipo, Priorità, Data Scadenza, Lavorante, Territorio, Provincia, Comune, Data em@il, Data Esito, Esito, Interventi Dimensionali, Interventi Infrastrutturali, Data Accettazione Cliente, Note
• Reset completo: pulsante per azzerare dashboard, filtri e grafici

10. Confronto DB Excel & Verifica GAT

Tool avanzato per verifica allineamento tra due versioni di database Excel con controllo specifico delle centrali GAT_A/GAT_Z:

• Confronto celle: analisi foglio per foglio, cella per cella, con identificazione precisa delle differenze
• Report TXT: export dettagliato delle differenze con coordinate riga/colonna/foglio
• Export JSON: conversione del primo foglio del DB nuovo in formato JSON standard
• Statistiche real-time: fogli confrontati, celle analizzate, differenze trovate, fogli esclusivi
• 🔎 Verifica GAT (RA/RC): controllo specifico che tutte le centrali GAT_A e GAT_Z del file VECCHIO siano presenti nel file NUOVO
• Fogli analizzati: per RA verifica il foglio archi, per RC verifica il foglio collegamenti
• Report anomalie: identifica centrali mancanti o con dati non allineati tra le due versioni
• Auto-detection tipo file: riconosce automaticamente se il DB caricato è RA, RC o entrambi

11. Marker Centrali su Mappa

Visualizzazione delle centrali di inizio e fine per ogni collegamento sulla mappa dei percorsi:

• Marker circolari blu con popup informativo
• Nome Centrale e CLLI visibili al click
• Deduplicazione automatica delle centrali ripetute
• Supporto completo per DB RA e DB RC

12. Filtro POP (NODO A1)

Toggle per filtrare le 32 centrali POP nazionali (NODO A1) come destinazione percorsi:

• Attivabile nei campi "Centrale di Arrivo" di entrambe le sezioni RC e RA
• Lista delle 32 centrali POP: ROMA, MILANO, TORINO, NAPOLI, BOLOGNA, FIRENZE, ecc.
• Match esatto sul CLLI (evita centrali omonime)
• Placeholder dinamico con indicatore visivo rosso quando attivo

13. Colorazione e Conteggio Collegamenti RA

Sistema di colorazione semantica e conteggio personalizzato per i collegamenti RA:

• Verde (T1↔T2, T2↔T2): Collegamenti principali, contano 1 ciascuno
• Blu TIM (T2↔T3): Collegamenti intermedi, contano 0.5 (ogni 2 = 1)
• Standard (T3↔T3): Collegamenti di transito, non contano
• Centrali di partenza e arrivo evidenziate in grassetto
• Percorsi diversificati automatici verso altra Tipo 1 sullo stesso arco

14. Gestione Archi Multipli e Selezione Obbligatoria (RA)

Sistema di rilevamento e gestione quando due centrali appartengono a più archi compatibili:

• Rilevamento automatico: il sistema verifica se le centrali di Partenza e Arrivo sono presenti su più archi
• Mini-label di avviso: quando gli archi compatibili sono multipli, compare il messaggio "⚠️ Più archi compatibili: seleziona 1 arco nella sezione Filtro per Arco per calcolare"
• Selezione obbligatoria: prima di calcolare il percorso, è necessario selezionare un singolo arco dal filtro "🔍 Filtro per Arco (Checkbox)"
• Disambiguazione percorso: la selezione dell'arco determina univocamente il percorso da calcolare lungo quella specifica direttrice
• Bottone [Premi Qui]: se una centrale appartiene a più archi, appare un bottone per visualizzare la lista completa degli archi

15. Ricerca Multi-Path (RA)

Funzionalità avanzata per calcolare tutti i percorsi su tutti gli archi compatibili tra due centrali:

• 🔀 Multi-Path: bottone dedicato che calcola contemporaneamente i percorsi Std su ogni arco condiviso tra Partenza e Arrivo
• Tabella risultati estesa: mostra una riga per ogni arco con colonna dedicata "🔗 Arco" che identifica l'arco di appartenenza
• Percorsi Div per arco: ogni riga ha un bottone "▶ Percorso Div" per calcolare il percorso diversificato specifico per quell'arco
• Visualizzazione mappa singola: bottone "🗺️" per visualizzare sulla mappa il singolo percorso di un arco specifico
• Mappa Multi-Path: visualizza tutti i percorsi di tutti gli archi sulla stessa mappa per un confronto visivo immediato
• Export TXT Multi-Path: esporta tutti i percorsi con indicazione dell'arco di appartenenza e eventuale Div calcolato

16. Ricerca Percorso Unificato (RA + RC)

Tab dedicato alla ricerca percorsi attraverso entrambe le reti RA e RC in modo integrato:

• 📍 Posizione Cliente: geocodifica indirizzi e trova automaticamente la centrale più vicina (RA o RC)
• 🔎 Trova Centrale Vicina: cerca nelle reti RA (Tipo 1/2) e RC simultaneamente usando algoritmo Haversine
• 🚀/🏁 Inserisci Partenza/Arrivo: toggle per scegliere dove inserire la centrale trovata
• 👥 Modalità Cliente Sede A → Rete → Sede Z: inserendo coordinate di due clienti, trova automaticamente le centrali più vicine e calcola il percorso ottimale
• 🔗 Interconnessione RA↔RC / RC↔RA: avviene automaticamente sui nodi con stesso CLLI (tipicamente [T1]/NODO A1). Inoltre il passaggio da un Arco RA a un altro Arco RA (RA↔RA) avviene tra sedi T1 e/o T2.
• Mix RA/RC: la colonna "Mix" nei risultati mostra la composizione del percorso (es. RA:3 • RC:2)
• 🔵 Filtro POP: filtra solo le centrali NODO A1 come destinazione

17. Memo e Promemoria S.d.F.

Sistema completo per la gestione dei promemoria associati alle Schede di Fattibilità:

• 📝 Bottone Header: accesso rapido al pannello Memo dal bottone 📝 nell'header della pagina
• Badge Contatore: mostra il numero di memo attivi direttamente sul bottone
• 👤 Colonna Cliente: visualizzazione del cliente nella tabella memo
• Memo Manuali: creazione di promemoria personalizzati con tutti i campi modificabili
• Import da S.d.F.: importazione memo direttamente dalla tabella S.d.F. Internalizzati con tutti i campi precompilati (incluso Cliente, Lavorante, Territorio, ecc.)
• Alert Scadenze: configurazione alert da 0 a 30 giorni prima della scadenza
• Campi Memo: Fattibilità, Cliente, Data Scadenza, Note, Alert, Esito, Tipo, Priorità
• Gestione Completa: modifica, elimina, cerca memo esistenti
• Export CSV: esportazione di tutti i memo in formato CSV
• 📊 Export Excel "Diario Lavoro": esportazione in formato Excel con:
  • Fogli separati per ogni lavorante
  • Formule automatiche per data e numero settimana
  • Larghezza colonne auto-fit, bordi minimal
  • Colonne CLIENTE e NOTE: 400px con word wrap
  • Colonne: ID, Date, Esito, Fattibilità, Tipo, Territorio, Provincia, Comune, Cliente, Interventi, Priorità, Note
• Persistenza: i memo sono salvati in localStorage e persistono tra le sessioni
• Distinzione Importati/Manuali: i memo importati hanno alcuni campi bloccati, quelli manuali sono completamente modificabili

18. Filtri Stati Collegamenti

Pannello espandibile per filtrare i percorsi in base allo stato dei collegamenti:

• 🔽 Bottone Filtri Stati: toggle per aprire/chiudere il pannello filtri in ogni tab (RC, RA, Unificato)
• Filtri RA: Attivo, Non Attivo [DA VERIFICARE SU NNI], In Attivazione, Da Verificare su NNI (4 stati)
• Filtri RC: Attivo, Non Attivo, In Attivazione, In Variazione, In Reinstradamento (5 stati)
• Applicazione istantanea: i filtri si applicano in tempo reale ai risultati della ricerca
• Persistenza scope: i filtri selezionati sono separati per ogni tab e vengono ricordati

19. Comparatore a 3 Percorsi

Sistema avanzato per confrontare visivamente fino a 3 percorsi affiancati:

• ⚖️ Bottone Confronta: attiva il comparatore quando sono disponibili almeno 2 percorsi
• Selettori colorati: 🔵 Percorso A (blu), 🔴 Percorso B (rosso), 🟢 Percorso C (verde)
• Metriche confrontate: distanza km, numero hop, lista collegamenti con stato colorato
• Formato percorso: Nome (CLLI) [TipoSede] :RA: oppure Nome (CLLI) :RC:
• Overlap %: calcolo automatico della percentuale di sovrapposizione tra percorsi
• Evidenziazione: il percorso migliore/peggiore per ogni metrica viene evidenziato
• Titolo dinamico: mostra centrali partenza→arrivo con CLLI e TipoSede

20. Condivisione Ricerche

Funzionalità per generare e condividere link con parametri di ricerca preconfigurati:

• 🔗 Bottone Condividi: genera un codice/link condivisibile con tutti i parametri attuali
• Parametri inclusi: centrali partenza/arrivo, filtri, vincoli obbligatori/evitare
• Toggle comportamento: clic ripetuto chiude il pannello di condivisione
• Auto-chiusura: il pannello si chiude automaticamente dopo 10 secondi
• Copia clipboard: bottone per copiare il codice negli appunti

21. Dark Mode Completo

Modalità scura completa per ridurre l'affaticamento visivo in ambienti con poca luce:

• 🌙 Toggle Header: pulsante nell'header per attivare/disattivare la modalità scura
• 21+ elementi corretti: popup, tabelle, card, form, cronologia, paginazione
• Persistenza: la preferenza viene salvata e ricordata tra le sessioni
• Box colorati preservati: i box nella documentazione mantengono i colori originali
• Blocchi codice: testo bianco su sfondo scuro per leggibilità ottimale

22. Calendario Memo con Scadenze

Visualizzazione calendario interattivo delle scadenze nel popup Memo:

• 📅 Tab Calendario: secondo tab nel popup Memo per vista calendario mensile
• Navigazione mesi: bottoni ◀ ▶ per navigare tra i mesi, bottone "Oggi" per tornare alla data corrente
• Evidenziazione scadenze: i giorni con scadenze sono evidenziati in giallo, quelli urgenti in rosso
• Badge contatore: ogni giorno mostra il numero di scadenze presenti
• Dettaglio scadenze: cliccando su un giorno, mostra l'elenco delle S.d.F. in scadenza
• Layout ottimizzato: calendario fisso in alto, lista scadenze scrollabile sotto
• Popup adattivo: il popup è più alto (95vh) quando nel tab Calendario

23. Sistema Messaggi Toast/Popup (V31.04)

Sistema di notifiche moderno e unificato che sostituisce gli alert browser nativi con feedback visivi eleganti e non intrusivi:

• 🔔 Toast Notifications: messaggi non-bloccanti posizionati in alto a destra:
  • 4 tipi: ✅ success (verde), ❌ error (rosso), ⚠️ warning (ambra), ℹ️ info (blu)
  • Auto-dismiss dopo 3 secondi con progress bar animata
  • Stacking automatico (max 5 toast visibili)
  • Dismissable con click
• 💬 Popup Modali: finestre di dialogo per messaggi importanti:
  • Backdrop blur con overlay scuro per focus
  • Animazioni entrata/uscita fluide (scale + fade)
  • Supporto bottoni multipli personalizzati
  • Focus trap e chiusura con tasto Escape
• ⚡ Logica Intelligente: scelta automatica del tipo di notifica:
  • Toast: messaggi SUCCESS e INFO brevi (<150 caratteri, <3 righe)
  • Popup: messaggi WARNING e ERROR (sempre, qualsiasi lunghezza)
  • Popup: messaggi lunghi (>150 caratteri o >3 righe)
• ♿ Accessibilità: rispetto degli standard WCAG:
  • Animazioni ridotte se prefers-reduced-motion attivo
  • ARIA labels per screen readers
  • Focus management per navigazione tastiera
  • Contrasto colori adeguato

Algoritmo Dijkstra Modificato

Il core di CRO utilizza una variante ottimizzata dell'algoritmo di Dijkstra per trovare i K-shortest paths (K=30) in un grafo pesato rappresentante la rete RC Italia.

Pseudocodice Dijkstra con Vincoli

function dijkstraWithConstraints(graph, start, end, constraints):
    // Inizializzazione
    distances = Map() // distanza minima da start
    previous = Map()  // nodo predecessore
    pqueue = PriorityQueue() // coda priorità (min-heap)
    
    // Imposta distanze iniziali
    for each node in graph.nodes:
        distances[node] = INFINITY
        previous[node] = NULL
    
    distances[start] = 0
    pqueue.push(start, 0)
    
    while pqueue is not empty:
        current = pqueue.pop()
        
        if current == end:
            break // Percorso trovato
        
        for each neighbor in graph.neighbors(current):
            // Applica vincoli
            if isBlacklisted(neighbor, constraints):
                continue
            
            if !meetsConstraints(neighbor, constraints):
                continue
            
            // Calcola distanza attraverso current
            alt = distances[current] + graph.weight(current, neighbor)
            
            if alt < distances[neighbor]:
                distances[neighbor] = alt
                previous[neighbor] = current
                pqueue.push(neighbor, alt)
    
    // Ricostruisci percorso
    return reconstructPath(previous, start, end)

Algoritmo Path Diversification (Div)

Per calcolare i 10 percorsi alternativi diversificati (Div), CRO implementa un algoritmo di penalizzazione archi per garantire overlap massimo 30% rispetto al percorso primario 1.1.

function calculateDiversifiedPaths(graph, start, end, primaryPath):
    diversifiedPaths = []
    primaryEdges = Set(primaryPath.edges)
    
    for i = 1 to 10:
        // Penalizza archi del percorso primario
        tempGraph = graph.clone()
        for each edge in primaryEdges:
            tempGraph.weight(edge) *= 10
        
        // Calcola percorso alternativo
        altPath = dijkstra(tempGraph, start, end)
        
        // Valida overlap
        overlap = calculateOverlap(altPath, primaryPath)
        if overlap <= 0.30:
            diversifiedPaths.push(altPath)
            // Aggiungi archi di altPath al set di penalizzazione
            primaryEdges.addAll(altPath.edges)
        
        if diversifiedPaths.length >= 10:
            break
    
    return diversifiedPaths

Validazione Topologica

CRO esegue validazioni automatiche su ogni percorso calcolato:

1. Connessione Fisica - Ogni hop deve essere un collegamento esistente in LINKS
2. Rispetto Vincoli - Centrali obbligatorie presenti, blacklist rispettate
3. Range Distanza - Distanza totale tra min/max specificati
4. Range Collegamenti - Numero hop tra min/max specificati
5. Stato Collegamenti - Se "Solo NON ATTIVI" attivo, tutti gli hop devono essere NON_ATTIVO
6. Tipo Centrali - Validazione sequenze Tipo 1 ↔ Tipo 2 (Tipo 3 trasparente)
7. No Loops - Nessuna centrale visitata più volte nel percorso

Eliminazione Duplicati

Percorsi identici (stessa sequenza centrali) vengono eliminati tramite hash-based deduplication. Hash calcolato: SHA256(centrali.join('-')). Complessità: O(N) con N=numero percorsi.

Schema Centrali (NODES)

Ogni centrale è rappresentata da un oggetto JSON con i seguenti campi:

Schema Collegamenti (LINKS)

Ogni collegamento è rappresentato da un oggetto JSON con i seguenti campi:

Relazioni e Integrità Referenziale

Indicizzazione e Performance

Indici creati per query ottimali:

Formato Storage JSON

Esempio record completo:

"NODES" e "LINKS"
Estratti dal DA RA e DB RC

var RAW_DB = [
   {
    "IdCollegamento": "CAM001",
    "DR": NaN,
    "Vendor": "HUAWEI",
    "GAT_A": "PESCARA",
    "CLLI_A": "PESCITAL",
    "TipoSedeA": NaN,
    "Lat_GAT_A": 42.468478,
    "Lon_GAT_A": 14.209443,
    "GAT_Z": "PESCARA TIBURTINA",
    "CLLI_Z": "PESCITAK",
    "TipoSedeZ": "-",
    "Lat_GAT_Z": 42.451796,
    "Lon_GAT_Z": 14.202591,
    "Distanza_km": 3.07,
    "Zona": "AM",
    "Regione": "Abruzzo + Molise",
    "Area": "CENTRO",
    "Tipo": "-",
    "TipoPortante": "DWDM",
    "IdCavo": "-",
    "SubPath": "-",
    "Stato_IdCollegamento": "NON ATTIVO",
    "Note": "-"
  }
   ....

var RAW_DB_RA = [
  {
    "IdCollegamento": "AM_arco_101|AM_12|AAM003/1|1",
    "DR": "AM",
    "Vendor": "HUAWEI",
    "GAT_A": "ATRI 2",
    "CLLI_A": "ATRIITAE",
    "TipoSedeA": 2,
    "Lat_GAT_A": "42.578437",
    "Lon_GAT_A": "13.983768",
    "GAT_Z": "PINETO",
    "CLLI_Z": "SILVITAC",
    "TipoSedeZ": 2,
    "Lat_GAT_Z": "42.608746",
    "Lon_GAT_Z": "14.063255",
    "Distanza_km": 11.69,
    "Zona": "AM",
    "Regione": "Abruzzo / Molise",
    "Area": "CENTRO",
    "Tipo": "S",
    "TipoPortante": "C-FOS",
    "IdCavo": "ATRIITAE/SILVITAC/C-FOS/00001",
    "SubPath": "AAM003/1",
    "Stato_IdCollegamento": "ATTIVO",
    "Note": null,
    "IdCollegamento (Ramo)": "AM_12",
    "Arco": "AM_arco_101",
    "Prog (Ramo/Arco)": 1
  }
   ....

Funzioni Core di Routing

// Esempio uso
document.getElementById('btn-search').onclick = runBaseRoutesSearch;

// Esempio uso
const result = calculateShortestPath('ROMA001', 'MILANO001', {
  mandatory: ['FIRENZE001'],
  blacklist: ['BOLOGNA001'],
  maxDistance: 600
});
console.log(result.path); // ['ROMA001', 'FIRENZE001', 'MILANO001']

Funzioni Database

// Esempio uso
const results = searchNodes('ROMA');
results.forEach(node => console.log(node.name));

Funzioni Mappa

// Esempio uso
const polyline = drawRouteOnMap(['ROMA001', 'FIRENZE001'], '#0066CC');
polyline.bindPopup('Percorso ROMA-FIRENZE');

Funzioni Export

Eventi e Callbacks

Catalogo Error Codes

Debug Workflow Step-by-Step

Log Analysis

Console Browser - Messaggi Chiave da Monitorare:

// Log successo
[CRO] Database caricato: 500 centrali, 5700 collegamenti
[CRO] Calcolo completato in 187ms: 30 percorsi trovati

// Log warning
[CRO] Warning: Blacklist contiene 50% centrali - percorsi limitati
[CRO] Warning: Timeout OSRM - routing stradale non disponibile

// Log errore
[CRO] Error ERR_002: Nessun percorso tra ROMA001 e ISOLA_X
[CRO] Error: Mappa non inizializzata - retry in 2s

Problemi Comuni e Fix Rapidi

Benchmark Reference

Tempi medi su hardware standard (Intel i5, 8GB RAM, Chrome):

Ottimizzazioni Implementate

Best Practices Utilizzo

1. Chiudi tab non utilizzati - CRO usa ~150MB RAM, libera risorse
2. Usa Chrome o Firefox - Engine JavaScript 20% più veloce di Safari/Edge
3. Limita vincoli - Ogni vincolo aggiuntivo aumenta complessità ~15%
4. Calcola percorsi in batch - Evita calcoli singoli ripetuti
5. Disabilita rendering mappa durante batch - 3x speedup su operazioni massive
6. Clear localStorage periodicamente - Ogni 50 ricerche per prevenire slow-down
7. Ricarica pagina dopo 100+ operazioni - Memory leaks minimi ma presenti

Configurazioni Avanzate (Sviluppatori)

// File: config.js - Performance Tuning

// Numero max percorsi da calcolare (default: 30)
const MAX_PRIMARY_ROUTES = 30; // Riduci a 10 per +70% speed

// Timeout calcolo (default: 30000ms)
const CALCULATION_TIMEOUT = 30000; // Aumenta se network complex

// Cache size (default: 100)
const CACHE_SIZE = 100; // Aumenta a 500 per +10% hit rate

// Virtual scrolling threshold (default: 1000)
const VIRTUAL_SCROLL_THRESHOLD = 1000; // Riduci a 500 per low-end

// Debounce delay (default: 300ms)
const DEBOUNCE_DELAY = 300; // Riduci a 150ms per UX più reattiva

Formati Export Supportati

PERCORSI PRIMARI (Std):
===================================
1.1 | ROMA SUD → FIRENZE NORD → MILANO CENTRO | 476.32 km | 2 hop
    Collegamenti: LINK001, LINK045
    ID: ROMA001-FIRENZE001-MILANO001

PERCORSI ALTERNATIVI (Div):
===================================
2.1 | ROMA SUD → BOLOGNA EST → MILANO CENTRO | 512.10 km | 2 hop
    Collegamenti: LINK078, LINK123
    Overlap: 15%

ID,Tipo,Centrali,Collegamenti,Distanza_km,Hop
1.1,Primario,"ROMA SUD|FIRENZE NORD|MILANO","LINK001|LINK045",476.32,2
2.1,Alternativo,"ROMA SUD|BOLOGNA EST|MILANO","LINK078|LINK123",512.10,2

Tool Esterni Compatibili

API Endpoints (Future Release)

Roadmap per integrazione backend:

Workflow Integrazione Tipico

A-D

Attenuazione (α)

Perdita di potenza segnale ottico lungo fibra. Unità: dB/km. Valori tipici: 0.22 dB/km @ 1550nm (SM)

CLLI (Common Language Location Identifier)

Codice standard ITU-T E.164 per identificazione univoca centrali/siti. Formato: 8-11 caratteri alfanumerici

CR/GI (Change Request / Gestione Impianti)

Processi Telecom Italia per richieste modifiche rete e gestione asset infrastrutturali

Dijkstra

Algoritmo greedy per shortest path in grafi pesati. Complessità: O(|E| + |V|log|V|) con Fibonacci heap

DWDM (Dense Wavelength Division Multiplexing)

Tecnologia multiplexing ottico con 40-80+ canali su singola fibra. Spacing: 50 GHz (ITU-T G.694.1)

E-H

EDFA (Erbium-Doped Fiber Amplifier)

Amplificatore ottico per banda C (1530-1565 nm). Gain tipico: 20-30 dB

GAT

Codice identificativo interno Telecom Italia per gestione asset territoriali

Haversine

Formula trigonometrica per calcolo distanza ortodromica (great-circle) su sfera. Errore <0.5% per distanze <1000 km

Hop

Singolo collegamento tra due centrali adiacenti. Count: numero totale collegamenti in un percorso

I-O

ITU-T (International Telecommunication Union - Telecom)

Organismo standardizzazione internazionale telecomunicazioni. Standard rilevanti: G.652 (fibra), G.694.1 (DWDM)

K-Shortest Paths

Algoritmo per trovare K percorsi più corti (non solo il migliore). CRO: fino a K=300 per primari (default: 30), K=10 per alternativi

Leaflet

Libreria JavaScript open-source per mappe interattive. Lightweight (39 KB gzipped)

Monomodale (SM - Single Mode)

Fibra ottica con core 9 μm. Per lunghe distanze (>2 km). Bande: O, E, S, C, L

Nominatim

Geocoding engine OpenStreetMap. API pubblica con rate limit: 1 req/sec

Overlap

Percentuale archi condivisi tra due percorsi. Formula: (Archi_comuni / Archi_totali) × 100

OSRM (Open Source Routing Machine)

Engine routing stradale basato su OpenStreetMap. Algoritmo: Contraction Hierarchies

P-Z

Percorso Primario (Std)

Percorso ottimizzato per distanza minima senza penalizzazioni. CRO calcola fino a 300 percorsi Std (default: 30)

Percorso Alternativo (Div)

Percorso diversificato con overlap <30% vs 1.1. Per ridondanza e disaster recovery

RA Italia (Rete Aggregation Italia)

Rete di aggregazione TIM che raccoglie traffico dalle centrali periferiche verso i nodi Core (NODO A1). Struttura gerarchica: Tipo 3 → Tipo 2 → Tipo 1

RC Italia (Rete Core Italia)

Backbone nazionale TIM S.p.A. Layer 0/1 (fibra/DWDM) per interconnessione centrali principali. Include 32 NODO A1 (POP nazionali)

Rete Revolution

Progetto TIM di evoluzione infrastruttura ottica nazionale. Modernizzazione rete trasporto con tecnologie DWDM di nuova generazione e incremento capacità

Tipo 1 / Tipo 2 / Tipo 3

Classificazione centrali TIM. Tipo 1: HUB RA+RC (NODO A1, interconnesso Core). Tipo 2: HUB RA (nodi intermedi). Tipo 3: Passaggio (endpoint/trasparenti)

WGS84 (World Geodetic System 1984)

Sistema riferimento geodetico standard GPS. Coordinate: latitudine (-90,+90), longitudine (-180,+180)

Standard ITU-T Riferimento

1. Raccolta requisiti da ticket CR/GI: centrali A-B, vincoli, requisiti di ridondanza
2. Verifica esistenza centrali nel database (tab "Database")
3. Impostazione filtri geografici (es. solo Area LAZIO per ridurre search space)
4. Configurazione vincoli: centrali obbligatorie, centrali da evitare, distanza/hop min-max
5. Esecuzione ricerca: click "Avvia Ricerca" → elaborazione 2-10 secondi
6. Analisi risultati: confronto distanze, numero hop, percorsi dettagliati nella tabella
7. Visualizzazione mappa: click su percorso + "Visualizza su Mappa" per analisi topografica
8. Calcolo attenuazione: vai al tab "Calcolo Attenuazione" (menu Analisi Extra), inserisci lunghezza e tipo fibra
9. Selezione percorso ottimale: basati su distanza, attenuazione, diversificazione geografica
10. Export documentazione: esporta in TXT (allegato tecnico) o CSV (elaborazioni)
11. Archiviazione: salva screenshot mappa, allega export a ticket CR/GI, usa Undo per tornare indietro se necessario

Requisito CR/GI: Collegamento ROMA SUD → ROMA INVIOLATELLA con transito per ROMA OSTIENSE.

Procedura:

1. Tab "Ricerca Percorsi": inserisci Partenza: "ROMA SUD"
2. Inserisci Arrivo: "ROMA INVIOLATELLA"
3. In "Centrali Obbligatorie" seleziona: ROMA OSTIENSE
4. Opzionale: imposta Distanza Max: 50 km
5. Click "Avvia Ricerca"

Risultato atteso:

Il sistema calcola percorsi che DEVONO passare per ROMA OSTIENSE. Ricevi:

• Percorso primario 1.1: ROMA SUD → ROMA OSTIENSE → ROMA INVIOLATELLA
• Percorsi alternativi 2.1, 2.2, ... (se esistono) geograficamente diversificati
• Distanze parziali per ogni hop
• Coordinate WGS84 di ogni centrale attraversata

Verifica attenuazione:

Se il percorso 1.1 è lungo 35 km con 3 collegamenti (6 connettorizzazioni), vai al tab "Calcolo Attenuazione" (menu Analisi Extra):

• Lunghezza tratta: 35 km
• Tipo fibra: SM 1550 nm (α = 0.22 dB/km)
• Collegamenti: 3 (= 6 connettorizzazioni × 0.3 dB)

Risultato: Perdita totale = (35 × 0.22) + (6 × 0.3) = 7.7 + 1.8 = 9.5 dB
Dentro budget tipico OTN (15-20 dB) → ✓ Collegamento FATTIBILE

Giuseppe Lupoli